<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   
      <title>Switching a Working Copy</title>
      <link rel="stylesheet" href="corpstyle.css" type="text/css">
      <meta name="generator" content="DocBook XSL Stylesheets V1.65.1">
      <link rel="home" href="index.html" title="The eSvn User Manual">
      <link rel="up" href="ch03.html" title="Chapter&nbsp;3.&nbsp;Using eSvn">
      <link rel="previous" href="ch03s18.html" title="Merging">
      <link rel="next" href="ch03s20.html" title="Reverting">
   </head>
   <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
      <div class="navheader">
         <table width="100%" summary="Navigation header">
            <tr>
               <th colspan="3" align="center">Switching a Working Copy</th>
            </tr>
            <tr>
               <td width="20%" align="left"><a accesskey="p" href="ch03s18.html"><img src="common/navig/prev.gif" alt="Prev"></a>&nbsp;
               </td>
               <th width="60%" align="center">Chapter&nbsp;3.&nbsp;Using eSvn</th>
               <td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s20.html"><img src="common/navig/next.gif" alt="Next"></a></td>
            </tr>
         </table>
         <hr>
      </div>
      <div class="sect1" lang="en">
         <div class="titlepage">
            <div>
               <div>
                  <h2 class="title" style="clear: both"><a name="esvn-switch"></a>Switching a Working Copy
                  </h2>
               </div>
            </div>
            <div></div>
         </div>
         <p>To update the working copy to a different URL use the Switch option
                    (
            <span class="guimenu">Modify</span>-&gt;<span class="guimenuitem">Switch</span> (<span><b class="shortcut"><span class="keysym">Alt+S</span></b></span>)
            ). This option updates your working copy to mirror a new URL&#8212;usually a
                    URL which shares a common ancestor with your working copy, although not necessarily. This is
                    the <span><b class="application">subversion</b></span> way to move a working copy to a new branch.
         </p>
         <p>After "switching" to the branch, your working copy is no different
                    than what you would get from doing a fresh checkout of the directory. It is usually more
                    efficient to use this command, because often branches only differ by a small degree. The
                    server sends only the minimal set of changes necessary to make your working copy reflect the
                    branch directory. The <tt class="interfacename">Switch</tt> dialog provides the following fields:
         </p>
         <div class="variablelist">
            <dl>
               <dt><span class="term">URL</span></dt>
               <dd>
                  <p>The URL against which the working copy will be updated.</p>
               </dd>
               <dt><span class="term">
                                 <span class="bold"><b>Revision</b></span>
                               </span></dt>
               <dd>
                  <p>Select the radio button and enter a value equal to a revision number.
                                   <tt class="varname">KEYWORDS</tt> are supported: 
                  </p>
                  <div class="variablelist">
                     <dl>
                        <dt><span class="term">HEAD</span></dt>
                        <dd>
                           <p>The latest revision in the repository.</p>
                        </dd>
                        <dt><span class="term">BASE</span></dt>
                        <dd>
                           <p>The "pristine" revision of an item in a working copy.</p>
                        </dd>
                        <dt><span class="term">COMMITTED</span></dt>
                        <dd>
                           <p>The last revision in which an item changed before (or at) BASE.</p>
                        </dd>
                        <dt><span class="term">PREV</span></dt>
                        <dd>
                           <p>The revision just before the last revision in which an item changed. (Technically,
                              					<span><b class="command">COMMITTED - 1</b></span>.)
                           </p>
                        </dd>
                     </dl>
                  </div>
               </dd>
               <dt><span class="term">
                                 <span class="bold"><b>Date</b></span>
                               </span></dt>
               <dd>
                  <p>Select the radio button and enter a value equal to a revision date or time.
                                   Specify date or time using any of the following syntax:
                  </p>
                  <div class="itemizedlist">
                     <ul type="disc" compact>
                        <li>
                           <p>2004-02-17</p>
                        </li>
                        <li>
                           <p>15:30</p>
                        </li>
                        <li>
                           <p>15:30:00.200000</p>
                        </li>
                        <li>
                           <p>2004-02-17 15:30</p>
                        </li>
                        <li>
                           <p>2004-02-17 15:30 +0230</p>
                        </li>
                        <li>
                           <p>2004-02-17T15:30</p>
                        </li>
                        <li>
                           <p>2004-02-17T15:30Z</p>
                        </li>
                        <li>
                           <p>2004-02-17T15:30-04:00</p>
                        </li>
                        <li>
                           <p>20040217T1530</p>
                        </li>
                        <li>
                           <p>20040217T1530Z</p>
                        </li>
                        <li>
                           <p>20040217T1530-0500</p>
                        </li>
                     </ul>
                  </div>
               </dd>
               <dt><span class="term">Tag</span></dt>
               <dd>
                  <p>Use to specify the folder name in the tag folder of the repository against which
                                   to update the working copy.
                  </p>
               </dd>
               <dt><span class="term">Branch</span></dt>
               <dd>
                  <p>Use to specify the folder name in the branch folder of the repository against
                                   which to update the working copy.
                  </p>
               </dd>
               <dt><span class="term">Trunk</span></dt>
               <dd>
                  <p>Use to specify the folder name in the trunk folder of the repository against which
                                   to update the working copy.
                  </p>
               </dd>
               <dt><span class="term">
                                 <span><b class="guibutton">Change URL</b></span>
                               </span></dt>
               <dd>
                  <p>Changes the path of a selected item in the <i class="guilabel">URL</i> field to point
                                   to the <i class="guilabel">Tag</i>, <i class="guilabel">Branch</i>, or
                                   <i class="guilabel">Trunk</i> folder name in the repository.
                  </p>
               </dd>
               <dt><span class="term">Non-recursive</span></dt>
               <dd>
                  <p>Operate on single directory only.</p>
               </dd>
            </dl>
         </div>
      </div>
      <div class="navfooter">
         <hr>
         <table width="100%" summary="Navigation footer">
            <tr>
               <td width="40%" align="left"><a accesskey="p" href="ch03s18.html"><img src="common/navig/prev.gif" alt="Prev"></a>&nbsp;
               </td>
               <td width="20%" align="center"><a accesskey="u" href="ch03.html"><img src="common/navig/up.gif" alt="Up"></a></td>
               <td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s20.html"><img src="common/navig/next.gif" alt="Next"></a></td>
            </tr>
            <tr>
               <td width="40%" align="left" valign="top">Merging&nbsp;</td>
               <td width="20%" align="center"><a accesskey="h" href="index.html"><img src="common/navig/home.gif" alt="Home"></a></td>
               <td width="40%" align="right" valign="top">&nbsp;Reverting</td>
            </tr>
         </table>
      </div>
   </body>
</html>